Release 10.1A: OpenEdge Development:
Progress 4GL Reference

AUDIT-ENABLED function

Determines whether a connected database is audit-enabled.

For information about audit-enabling a database, or creating and activating an audit policy for a database, see OpenEdge Getting Started: Core Business Services .

Syntax

AUDIT-ENABLED( [ integer-expression | logical-name | alias ] )

integer-expression

The sequence number of a connected database to query. For example, AUDIT-ENABLED(1) queries the first database, AUDIT-ENABLED(2) queries the second database, and so on. If you specify a sequence number that does not correspond to a connected database, Progress returns the Unknown value (?).

logical-name or alias

The logical name or alias of a connected database to query. These forms require a quoted character string or a character expression. If you specify a logical name or alias that does not correspond to a connected database, Progress returns the Unknown value (?).

If you specify a connected database, Progress queries that database and returns TRUE if it is audit-enabled. If you do not specify a database, Progress queries all connected databases and returns TRUE if any one of the connected databases is audit-enabled.

You can reference the AUDIT-ENABLED function within a preprocessor &IF expression (such as, &IF AUDIT-ENABLED … &ENDIF). For more information, see the &IF, &THEN, &ELSEIF, &ELSE, and &ENDIF preprocessor directives reference entry.

See also

AUDIT-POLICY system handle